home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / pcr / pcr4_4.lha / DIST / README < prev   
Text File  |  1992-04-17  |  2KB  |  85 lines
  1. #
  2. # README
  3. #
  4. #   Demers, November 1, 1988 4:30:09 pm PST
  5. #   Weiser, December 1, 1989    
  6. #   Boehm, September 17, 1991
  7. #
  8.  
  9. See below for installation instructions.
  10.  
  11. Some terms:
  12.  
  13. CONFIG:  A config is a build of the system with a particular set of switches.
  14. At one time there were many kinds of configs, like Threads, PseudoThreads,
  15. StandAlone, and SoftCard.  Currently there are only two: Threads and
  16. OptThreads.
  17.  
  18. It is easy to add new configs: the makefile explains, and gives examples of,
  19. how.
  20.  
  21. This subtree contains the following directories, which are filled in by make:
  22.  
  23. INCLUDE:
  24.  
  25.     header files
  26.  
  27. BIN:
  28.  
  29.     A subdirectory for each config, containing executable files associated
  30.     with that config.
  31.  
  32. LIB:
  33.  
  34.     A subdirectory for each config, containing libraries associated with the
  35.     config.
  36.     
  37.     In particular, for each config there is a library named "xr.a" which
  38.     contains the components of the runtime itself.  The object file XRRoot.o
  39.     has undefined external symbols that cause the entire runtime to be loaded.
  40.  
  41. SRC:
  42.  
  43.     A single directory containing all sources.  (Pointing dbx at this directory
  44.     can be useful.)
  45.  
  46. MAN: 
  47.  
  48.     Manual entries.
  49.  
  50. INSTALLATION INSTRUCTIONS:
  51.  
  52. 0. Don't be afraid to read the makefile ... it's pretty heavily commented.
  53.  
  54. 1. In fact, the first thing you need to do is edit the makefile.  It starts
  55. out with a couple of variables:
  56.  
  57.     XR_HOME = ...
  58.     INSTALL_MAN = ... (e.g. /usr/local/manl)
  59.  
  60. These should be changed to reflect local conventions at your site.
  61.  
  62. 2. Change the default values of environment values in boot/XRDBX.csh
  63. to ones that are reasonable for your site.  (Nothing else depends
  64. on this.  If you omit doing this, you will simply end up with a
  65. suboptimal XRDBX in the BIN directory when make finishes.  This will
  66. make it even harder to debug in PCR.)
  67.  
  68. 3. Then execute
  69.  
  70.     make install1
  71.  
  72. This will recompile every config, then rename the DIST subdirectory to the
  73. actual PCR version and create a symbolic link to it named INSTALLED.
  74.  
  75. 4. Once step 3 has completed, optionally execute
  76.  
  77.     su bin
  78.     ...
  79.     make install2
  80.  
  81. (replace "bin" above by whatever user owns your INSTALL_MAN directory; in some
  82. installations that's root (shudder)).  You may also want to move some
  83. executables from BIN to a more public place.
  84.  
  85.